\name{GetAvailableDatasetName}
\alias{GetAvailableDatasetName}
%- Also NEED an '\alias' for EACH other topic documented here.
\encoding{UTF-8}
\title{
Returns the name of a dataset that is not being used in a data source.
}
\description{
创建数据集时，数据集名称在同一个数据源文件中必须唯一，否则不能创建新的数据集，可以使用该方法返回一个合法的名称，但是该方法得到的名称不能保证一定符合您的最佳要求。 
数据集的名称限制：数据集名称的长度限制为30个字符（也就是可以为30个英文字母或者15个汉字），组成数据集名称的字符可以为字母、汉字、数字和下划线，数据集名称不可以用数字和下划线开头，数据集名称不可以和数据库的保留关键字冲突。
}
\usage{
GetAvailableDatasetName(ds, name)
}
%- maybe also 'usage' for other objects documented here.
\arguments{
  \item{ds}{
  数据源对象。
}
  \item{name}{
  数据集名称。
}
}
\details{
%%  ~~ If necessary, more details than the description above ~~
}
\value{
如果获取到有效的数据集名称，返回有效的数据集名称，否则返回NULL。
}
\references{
%% ~put references to the literature/web site here ~
}
\author{
%%  ~~who you are~~
}
\note{
%%  ~~further notes~~
}

%% ~Make other sections like Warning with \section{Warning }{....} ~

\seealso{
%% ~~objects to See Also as \code{\link{help}}, ~~~
}
\examples{
server <- system.file("/sampledata/ChangChun.udb", package="RSuperMap")
ds <- OpenDatasource(server, alias = "test", engine = "udb")
name <- "tempDataset"
name <- GetAvailableDatasetName(ds, name)
name
CloseDatasource(ds)
}
% Add one or more standard keywords, see file 'KEYWORDS' in the
% R documentation directory.
\keyword{ supermap }
